VC reorganization #10607

katarzyna-koltun-mx · 2026-01-16T16:23:42Z

No description provided.

content/en/docs/refguide/version-control/_index.md

katarzyna-koltun-mx · 2026-01-22T10:14:34Z

content/en/docs/refguide/version-control/configure/on-premises-git.md

 ---
-title: "Working with Git On-Premises Version Control Server"
-linktitle: "Git On-Premises Version Control Server"
+title: "Optional: Working with Private Git"


This topic has a lot of info about set up and configuration. Consider either splitting it up (enabling / configuring) or moving the whole thing into its own separate top-level topic (where?)

From my perspective the Optional: Working with Private Git as child of Configuring Version Control is fine. People will find it here, and having the information bundled is probably preferable over splitting it.

katarzyna-koltun-mx · 2026-02-10T12:15:45Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/peer-review.md

@@ -0,0 +1,29 @@
+---
+title: "Peer Reviewing Changes"


might need to rename this to Using History and include also troubleshooting as a use case.

In the 11.9 or 11.10 release more content will be added related to 'inspecting history' which is very important for reviewing, but still a more generic name about History is probably preferable.

katarzyna-koltun-mx · 2026-02-10T12:18:43Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/peer-review.md

+description: "Describes how to work with version control and how to resolve some issues which may arise."
+---
+
+## Introduction


link to https://docs.mendix.com/refguide/history-dialog/

katarzyna-koltun-mx · 2026-02-10T12:18:56Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/deploy-external.md

+description: "Describes how to work external tools to deploy packages."
+---
+
+## Introduction


link to https://docs.mendix.com/refguide/version-control-menu/

katarzyna-koltun-mx · 2026-02-10T12:21:33Z

Should also add linking to these topics back from https://docs.mendix.com/refguide/version-control-menu/ and its subpages as needed.

tknippenberg · 2026-02-11T09:41:15Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/_index.md

 linktitle: "Using Version Control"
-weight: 10
+weight: 50
 description: "Describes how to work with version control and how to resolve some issues which may arise."


Troubleshooting is no longer a part, or a child, of this Using version control page.

tknippenberg · 2026-02-11T09:42:09Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/_index.md

-## Read More
-
-* [Advanced Branching and Merging Strategies](https://www.mendix.com/blog/advanced-branching-merging-strategies-part-1-2/)
+For more information on how version control works in Mendix, see [Version Control](/refguide/version-control/).


This page now basically contains these two sentences, that seem contradictory 😅

This document describes how to use version control in Mendix Studio Pro.
For more information on how version control works in Mendix, see [Version Control].

tknippenberg · 2026-02-11T09:42:58Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/deploy-external.md

@@ -0,0 +1,80 @@
+---
+title: "Deploying Packages with External Tools"
+url: /refguide/using-version-control-in-studio-pro/


This URL is incorrect so the page doesn't open correctly when running the Docs site.

tknippenberg · 2026-02-11T09:44:06Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/deploy-external.md

@@ -0,0 +1,80 @@
+---
+title: "Deploying Packages with External Tools"


When reading the contents of this page, it seems to be about working with External Tools in general; not related to deploying?

tknippenberg · 2026-02-11T09:45:29Z

content/en/docs/refguide/version-control/version-control-glossary.md

+
+With more complex apps, you may want to manage your code in a more sophisticated way. For example, you may want to develop new features separately from the currently deployed version of your app so that you can fix any bugs without having to release all the new features. This is done using [Branch Lines](#branch-line).
+
+If you are already familiar with using branches, you can check the [Branching Best-Practices](/refguide/using-version-control-in-studio-pro/#branching-best-practices) section of *Using Version Control in Studio Pro* for advice on how to use branches when developing your Mendix app.


Link is incorrect.

tknippenberg · 2026-02-11T09:47:25Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/peer-review.md

+url: /refguide/peer-reviewing/
+linktitle: "Peer Reviewing"
+weight: 60
+description: "Describes how to work with version control and how to resolve some issues which may arise."


Description is not correct.

tknippenberg · 2026-02-11T09:48:19Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/peer-review.md

+
+Select a revision to see additional details, such as related stories, changed documents, Studio Pro version, and changes on disk. Icons summarize the kinds of changes that happened in the app.
+
+{{< figure src="/attachments/refguide/version-control/using-version-control-in-studio-pro/history-of-dialog.png" class="no-border" >}}


Suggest to replace this image with the one on https://docs.mendix.com/refguide/history-dialog/.

tknippenberg · 2026-02-11T09:48:59Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/push-pull.md

@@ -0,0 +1,163 @@
+---
+title: "Pushing, Pulling, and Comitting"


The normal order would be 'Pulling' (before you start working), 'Committing' and then 'Pushing'. Perhaps it make sense to reorder the title and description to accommodate for that.

tknippenberg · 2026-02-11T09:49:36Z

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/push-pull.md

+description: "Describes how to push, pull, and commit your changes."
+---
+
+## Introduction


This chapter is not correct? Seems to be copied from another page.

tknippenberg · 2026-02-11T09:53:35Z

content/en/docs/refguide/version-control/version-control-troubleshooting/_index.md

@@ -1,8 +1,7 @@
 ---
 title: "Troubleshooting Version Control"


For several pages (like "Using version control") we now have a basically empty page, with subpages.
For this troubleshooting page however, we have a full page, with two subpages. Is this something you'd want to make consistent?

tknippenberg · 2026-02-11T09:53:59Z

content/en/docs/refguide/version-control/version-control-troubleshooting/_index.md

+
+Mendix Studio Pro needs to connect to the Team Server, where all your apps are stored. If you are having issues connecting to the Team Server, see [Troubleshooting Team Server Issues](/refguide/troubleshoot-team-server-issues/).
+
 ### Getting an Unexpected Error: `The project contains changes that have not been committed yet. Please commit first before attempting to merge again.` {#css-error}


The formatting of this is ugly, and it has been bothering me for years. Do you have an idea how to improve this?

tknippenberg · 2026-02-11T09:57:24Z

content/en/docs/refguide/version-control/_index.md

 Version control in Mendix is built on top [Git](https://git-scm.com). The concepts will be familiar to seasoned users of these version control systems (VCS). Mendix simplifies the VCS commands by building them into Studio Pro and the Mendix Portal.

-## Concepts {#concepts}
+### Mendix Team Server


I think the structure within this page should be revised a bit. Most questions are 'server-related' but the PR chapter 5 isn't really related. And then chapter 6 is an overall 'documents in this category' section.

tknippenberg · 2026-02-11T09:58:15Z

content/en/docs/refguide/version-control/version-control-enable.md

@@ -0,0 +1,41 @@
+---
+title: "Enabling Version Control for Your App"


I'm not sure if this deserves to be a top-level page within the VC section. Perhaps we can move it down to the Configuring section?

VC reorganization

2ef3048

katarzyna-koltun-mx self-assigned this Jan 16, 2026

katarzyna-koltun-mx added 3 commits January 22, 2026 10:53

Reorganizing the TOC

a2f4f91

Reorganizing the TOC

d3021b8

Reorganizing the TOC

6dcdc9a

katarzyna-koltun-mx commented Jan 22, 2026

View reviewed changes

content/en/docs/refguide/version-control/_index.md Outdated Show resolved Hide resolved

katarzyna-koltun-mx commented Jan 22, 2026

View reviewed changes

content/en/docs/refguide/version-control/_index.md Outdated Show resolved Hide resolved

katarzyna-koltun-mx commented Jan 22, 2026

View reviewed changes

content/en/docs/refguide/version-control/_index.md Outdated Show resolved Hide resolved

katarzyna-koltun-mx commented Jan 22, 2026

View reviewed changes

katarzyna-koltun-mx and others added 3 commits January 22, 2026 17:39

SME review

4d1b8db

draft

76fedc3

Update _index.md

bcdfea7

katarzyna-koltun-mx commented Feb 10, 2026

View reviewed changes

tknippenberg reviewed Feb 11, 2026

View reviewed changes

		@@ -0,0 +1,80 @@
		---
		title: "Deploying Packages with External Tools"


		With more complex apps, you may want to manage your code in a more sophisticated way. For example, you may want to develop new features separately from the currently deployed version of your app so that you can fix any bugs without having to release all the new features. This is done using [Branch Lines](#branch-line).

		If you are already familiar with using branches, you can check the [Branching Best-Practices](/refguide/using-version-control-in-studio-pro/#branching-best-practices) section of Using Version Control in Studio Pro for advice on how to use branches when developing your Mendix app.


		Select a revision to see additional details, such as related stories, changed documents, Studio Pro version, and changes on disk. Icons summarize the kinds of changes that happened in the app.

		{{< figure src="/attachments/refguide/version-control/using-version-control-in-studio-pro/history-of-dialog.png" class="no-border" >}} No newline at end of file

		@@ -0,0 +1,163 @@
		---
		title: "Pushing, Pulling, and Comitting"


		Mendix Studio Pro needs to connect to the Team Server, where all your apps are stored. If you are having issues connecting to the Team Server, see [Troubleshooting Team Server Issues](/refguide/troubleshoot-team-server-issues/).

		### Getting an Unexpected Error: `The project contains changes that have not been committed yet. Please commit first before attempting to merge again.` {#css-error}

		@@ -0,0 +1,41 @@
		---
		title: "Enabling Version Control for Your App"

VC reorganization #10607

Are you sure you want to change the base?

VC reorganization #10607

Uh oh!

Conversation

katarzyna-koltun-mx commented Jan 16, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

katarzyna-koltun-mx commented Feb 10, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tknippenberg Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

tknippenberg Feb 11, 2026 •

edited

Loading